home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / ttcp.z / ttcp
Encoding:
Text File  |  2002-10-03  |  5.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. TTTTTTTTCCCCPPPP((((1111))))                                                                TTTTTTTTCCCCPPPP((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ttcp - test TCP and UDP performance
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ttttttttccccpppp ----tttt [----uuuu] [----ssss] [----pppp _p_o_r_t]]]] [----llll _b_u_f_l_e_n]]]] [----bbbb _s_i_z_e]]]] [----nnnn _n_u_m_b_u_f_s]]]] [----AAAA _a_l_i_g_n]]]]
  13.      [----OOOO _o_f_f_s_e_t]]]] [----ffff _f_o_r_m_a_t]]]] [----DDDD] [----vvvv]]]] host [<<<<in]]]]
  14.      ttttttttccccpppp ----rrrr [----uuuu] [----ssss] [----pppp _p_o_r_t]]]] [----llll _b_u_f_l_e_n]]]] [----bbbb _s_i_z_e]]]] [----AAAA _a_l_i_g_n]]]] [----OOOO _o_f_f_s_e_t]]]]
  15.      [----ffff _f_o_r_m_a_t]]]] [----BBBB] [----TTTT] [----vvvv] [>>>>out]]]]
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _T_t_c_p times the transmission and reception of data between two systems
  19.      using the UDP or TCP protocols.  It differs from common ``blast'' tests,
  20.      which tend to measure the remote _i_n_e_t_d as much as the network
  21.      performance, and which usually do not allow measurements at the remote
  22.      end of a UDP transmission.
  23.  
  24.      For testing, the transmitter should be started with ----tttt and ----ssss after the
  25.      receiver has been started with ----rrrr and ----ssss.  Tests lasting at least tens of
  26.      seconds should be used to obtain accurate measurements.  Graphical
  27.      presentations of throughput versus buffer size for buffers ranging from
  28.      tens of bytes to several ``pages'' can illuminate bottlenecks.
  29.  
  30.      _T_t_c_p can also be used as a ``network pipe'' for moving directory
  31.      hierarchies between systems when routing problems exist or when the use
  32.      of other mechanisms is undesirable. For example, on the destination
  33.      machine, use:
  34.  
  35.           ttcp -r -B | tar xvpf -
  36.  
  37.  
  38.      and on the source machine:
  39.  
  40.           tar cf - directory | ttcp -t dest_machine
  41.  
  42.  
  43.      Additional intermediate machines can be included by:
  44.  
  45.           ttcp -r | ttcp -t next_machine
  46.  
  47.  
  48. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  49.      -t        Transmit mode.
  50.  
  51.      -r        Receive mode.
  52.  
  53.      -u        Use UDP instead of TCP.
  54.  
  55.      -s        If transmitting, source a data pattern to network; if
  56.                receiving, sink (discard) the data.  Without the ----ssss option, the
  57.                default is to transmit data from _s_t_d_i_n or print the received
  58.                data to _s_t_d_o_u_t.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TTTTTTTTCCCCPPPP((((1111))))                                                                TTTTTTTTCCCCPPPP((((1111))))
  71.  
  72.  
  73.  
  74.      -l _l_e_n_g_t_h Length of buffers in bytes (default 8192).  For UDP, this value
  75.                is the number of data bytes in each packet.  The system limits
  76.                the maximum UDP packet length. This limit can be changed with
  77.                the ----bbbb option.
  78.  
  79.                When testing UDP performance, it is important to set the packet
  80.                size to be less than or equal to the maximum transmission unit
  81.                of the media.  Otherwise, IP fragmentation will distort the
  82.                test.  For Ethernet, set the length to 1508 bytes.
  83.  
  84.      -b _s_i_z_e   Set size of socket buffer.  The default varies from system to
  85.                system.  This parameter affects the maximum UDP packet length.
  86.                It may not be possible to set this parameter on some systems
  87.                (for example, 4.2BSD).
  88.  
  89.      -n _n_u_m_b_u_f_s
  90.                Number of source buffers transmitted (default 2048).
  91.  
  92.      -p _p_o_r_t   Port number to send to or listen on (default 5001).  On some
  93.                systems, this port may be allocated to another network daemon.
  94.  
  95.      -D        If transmitting using TCP, do not buffer data when sending
  96.                (sets the TCP_NODELAY socket option).  It may not be possible
  97.                to set this parameter on some systems (for example, 4.2BSD).
  98.  
  99.      -B        When receiving data, output only full blocks, using the block
  100.                size specified by ----llll.  This option is useful for programs, such
  101.                as _t_a_r(1), that require complete blocks.
  102.  
  103.      -A _a_l_i_g_n  Align the start of buffers to this modulus (default 16384).
  104.  
  105.      -O _o_f_f_s_e_t Align the start of buffers to this offset (default 0).  For
  106.                example, ``-A8192 -O1'' causes buffers to start at the second
  107.                byte of an 8192-byte page.
  108.  
  109.      -f _f_o_r_m_a_t Specify, using one of the following characters, the format of
  110.                the throughput rates as kilobits/sec ('k'), kilobytes/sec
  111.                ('K'), megabits/sec ('m'), megabytes/sec ('M'), gigabits/sec
  112.                ('g'), or gigabytes/sec ('G').  The default is 'K'.
  113.  
  114.      -T        ``Touch'' the data as they are read in order to measure cache
  115.                effects.
  116.  
  117.      -v        Verbose: print more statistics.
  118.  
  119.      -d        Debug: set the SO_DEBUG socket option.
  120.  
  121. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  122.      ping(1M), traceroute(1M), netsnoop(1M)
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.